Inside Macintosh: QuickDraw GX Printing /

Chapter 3 - Page Formatting and Dialog Box Customization / Page Formatting and Dialog Box Customization Reference

Functions / Working With Panels

GXSetupDialogPanel

You can use the GXSetupDialogPanel function to add a panel to a print dialog box.

OSErr GXSetupDialogPanel (gxPanelSetupRecord *panelRec);

panelRec

A pointer to a panel setup structure.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

The GXSetupDialogPanel function adds a panel, as defined by the information in the panel setup structure, to a print dialog box. You call this function from within your override of the gxJobPrintDialog, gxFormatDialog, and gxJobDefaultFormatDialog messages, before forwarding the message.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.
gxCantAddPanelsNowErr	Panels can only be added to a dialog box when the current driver is switched. This error is generated if a panel addition request is made at any other time.
gxBadxdtlKeyErr	An unknown key value was specified for an item in an extended dialog control resource.
gxXdtlItemOutOfRangeErr	An item referenced by the panel does not belong to the panel.
gxNoActionButtonErr	The action button for the panel is nil.
gxTitlesTooLongErr	The length of the button titles exceeds the maximum width allowed for a printing alert.

SEE ALSO

Listing 3-22 on page 3-68 shows how to use the GXSetupDialogPanel function to add a panel to the Custom Page Setup dialog box.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help